package com.xci.platform.auth.dao;

import com.xci.platform.auth.entity.DicDetailsEntity;
import com.xci.platform.core.Simple;
import com.xci.platform.core.Tree;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;
import java.util.Map;

/**
 * 系统字典明细数据访问接口
 */
@Mapper
public interface DicDetailsDao {

    /**
     * 新增字典明细
     *
     * @param entity 字典明细对象
     * @return 返回影响的行数
     */
    Integer insert(@Param("entity") DicDetailsEntity entity);

    /**
     * 更新字典明细
     *
     * @param entity 字典明细对象
     * @return 返回影响的行数
     */
    Integer update(@Param("entity") DicDetailsEntity entity);

    /**
     * 删除字典明细
     *
     * @param id 字典明细主键
     * @return 返回影响的行数
     */
    Integer delete(@Param("id") String id);

    /**
     * 根据字典主键删除字典明细
     *
     * @param dicId 字典主键
     * @return 返回影响的行数
     */
    Integer deleteByDicId(@Param("dicId") String dicId);

    /**
     * 根据主键更新排序路径
     *
     * @param id   主键
     * @param path 排序路径
     */
    Integer updatePathById(@Param("id") String id, @Param("path") String path);

    /**
     * 根据主键更新父节点以及排序路径
     *
     * @param id       主键
     * @param parentId 上级主键
     * @param path     排序路径
     */
    Integer updateParentAndPathById(@Param("id") String id, @Param("parentId") String parentId, @Param("path") String path);

    /**
     * 根据主键更新叶子节点状态
     *
     * @param id   主键
     * @param leaf 叶子节点状态
     */
    Integer updateLeafById(@Param("id") String id, @Param("leaf") Integer leaf);

    /**
     * 更新字典明细启用状态
     *
     * @param id     字典明细主键
     * @param status 是否启用(1:启用 0:禁用)
     */
    Integer updateStatus(@Param("id") String id, @Param("status") Integer status);

    /**
     * 根据主键更新字典编码和名称
     *
     * @param dicId   字典主键
     * @param dicCode 字典编码
     * @param dicName 字典名称
     */
    Integer updateDicCodeAndName(@Param("dicId") String dicId, @Param("dicCode") String dicCode, @Param("dicName") String dicName);

    /**
     * 验证指定字典明细编码是否存在
     *
     * @param name  字典明细名称
     * @param dicId 字典主键
     * @param id    字典明细主键
     * @return 如果存在返回true, 否则返回false
     */
    Integer existByName(@Param("name") String name, @Param("dicId") String dicId, @Param("id") String id);

    /**
     * 根据字典明细主键获取字典明细对象
     *
     * @param id 字典明细主键
     * @return 返回指定字典明细主键的字典明细对象
     */
    DicDetailsEntity queryById(@Param("id") String id);

    /**
     * 获取字典明细名称
     *
     * @param id 字典明细主键
     * @return 字典明细名称
     */
    String queryNameById(@Param("id") String id);

    /**
     * 获取字典明细值
     *
     * @param id 字典明细主键
     * @return 字典明细值
     */
    String queryValueById(@Param("id") String id);

    /**
     * 获取指定主键的排序路径
     *
     * @param id 主键
     */
    String queryPathById(@Param("id") String id);

    /**
     * 获取指定主键的子节点数
     *
     * @param id 主键
     */
    Integer queryChildCountById(@Param("id") String id);

    /**
     * 根据字典主键查询字典明细列表
     *
     * @param map 查询参数
     */
    List<DicDetailsEntity> queryByDic(Map map);

    /**
     * 根据字典编码获取数据字典明细简单对象列表
     *
     * @param dicCode 字典编码
     */
    List<Simple> querySimpleByDicCode(@Param("dicCode") String dicCode);

    /**
     * 根据字典编码获取数据字典对象列表
     *
     * @param dicCode 字典编码
     */
    public List<DicDetailsEntity> queryByDicCode(@Param("dicCode") String dicCode);

    /**
     * 动态加载字典明细列表
     *
     * @param id 字典明细主键
     * @return 字典明细列表
     */
    List<DicDetailsEntity> dynamicQuery(@Param("id") String id);

    /**
     * 查询Tree模型列表
     */
    List<Tree> queryTreeModelList(@Param("dicCode") String dicCode, @Param("status") Integer status);
}
